home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 016a / reboot5.zip / REBOOT.DOC < prev    next >
Text File  |  1991-08-01  |  43KB  |  878 lines

  1.  
  2.  
  3.  
  4.        REBOOT v5.00 User Manual                                Page  -1-
  5.  
  6.  
  7.                                                          1st August 1991
  8.  
  9.                                  REBOOT v5.00
  10.  
  11.                      (C) Copyright 1990, 1991, Peter Ogden
  12.  
  13.  
  14.  
  15.  
  16.                                    CONTENTS
  17.                                    --------
  18.  
  19.  
  20.        Caution.........................................................2
  21.        Limit of liability..............................................2
  22.        Purpose.........................................................2
  23.        License information.............................................3
  24.        Files included in the REBOOT suite..............................4
  25.        Compatibility...................................................4
  26.        Setting up......................................................4
  27.        Installing user options in REBOOT...............................7
  28.        Running REBOOT..................................................8
  29.        Sequence of events..............................................9
  30.        Companion programs.............................................10
  31.           ACTIVE......................................................10
  32.           BTIME.......................................................11
  33.           CHKBOOT.....................................................11
  34.        Trouble-shooting...............................................12
  35.           REBOOT.CFG corruption.......................................12
  36.           Erratic mouse flashing......................................12
  37.           Insufficent memory for editor...............................12
  38.           Error - unable to load editor...............................12
  39.           Error - unable to create temporary file.....................13
  40.           Error - unable to create REBOOT.TMP.........................13
  41.           Error - unable to open REBOOT.CFG...........................13
  42.           Error - null #Name encountered..............................13
  43.        Program history................................................14
  44.        About REBOOT...................................................16
  45.        Acknowledgements...............................................17
  46.  
  47.  
  48.  
  49.  
  50.        REBOOT v5.00 User Manual                                Page  -2-
  51.  
  52.  
  53.        **************************** CAUTION ****************************
  54.  
  55.        Users  of Delayed  Write disk  caches should  read this  document
  56.        thoroughly before using REBOOT. If REBOOT is not set up correctly
  57.        there is a slight possibility of damage to data on you hard disk.
  58.  
  59.        *****************************************************************
  60.  
  61.  
  62.                               LIMIT OF LIABILITY
  63.  
  64.        REBOOT is distributed as-is. The author disclaims all warranties,
  65.        expressed  or implied.  The author  will assume  no liability for
  66.        damages  either from  the direct  use  of  this product  or as  a
  67.        consequence  of  the  use  of  this product.  Further, the author
  68.        reserves the right to revise this publication and to make changes
  69.        from time to time in the content hereof without obligation of the
  70.        author to notify  any person or organisation of  such revision or
  71.        changes.
  72.  
  73.  
  74.                                     PURPOSE
  75.  
  76.        As application programs become larger and more complex, conflicts
  77.        between  programs  become  more and  more  common.  Some programs
  78.        simply  require  a  larger  amount  of  memory  than  is normally
  79.        available.  The simple solution  is to reboot the computer with a
  80.        different (non conflicting, or low memory use) configuration.
  81.  
  82.        The REBOOT  suite of programs  have been written  to perform this
  83.        task, and to  preserve the users environment as  much as possible
  84.        across these reboots, and with special handling for 4DOS.
  85.  
  86.        REBOOT  can  reboot  the  computer  with  a  new  CONFIG.SYS  and
  87.        AUTOEXEC.BAT  selected from  a list  of choices  (maximum of  128
  88.        configurations allowed). Delayed write (also called staged write)
  89.        disk caches are catered for. For users of 4DOS 3.0 and above, the
  90.        command history list can be written  to a file before booting (if
  91.        you  don't use  4DOS currently,  you should try it).  The various
  92.        configurations are kept in a single file (REBOOT.CFG).
  93.  
  94.        Note: 4DOS is a shareware  replacement (by J.P. Software) for the
  95.              MS/PC-DOS COMMAND.COM.  It enhances the  existing commands,
  96.              adds several new commands,  scrollable command history, and
  97.              heaps more.  If you work  with DOS at  the command line  or
  98.              write complex batch files, you should be using it!  4DOS is
  99.              available on good BBS's all over the world.
  100.  
  101.  
  102.  
  103.  
  104.        REBOOT v5.00 User Manual                                Page  -3-
  105.  
  106.  
  107.                               LICENSE INFORMATION
  108.  
  109.        REBOOT  is  the  copyrighted  property  of  Peter Ogden.  You are
  110.        granted a limited license to use, copy, and distribute the REBOOT
  111.        suite of programs provided the following conditions are met:
  112.  
  113.           A. Copying  and  distribution  fees   may  not  exceed  $15.00
  114.              Australian.
  115.  
  116.           B. REBOOT may  only be distributed in  its original unmodified
  117.              state.
  118.  
  119.        This software  is distributed under  the user supported  software
  120.        concept. Though REBOOT is copyrighted, you are encouraged to copy
  121.        and distribute this program to others.  If you  like this product
  122.        and find  it useful, a  registration fee of  $20.00 Australian is
  123.        required for continued use. A twelve month instant update plan is
  124.        available  (new  versions  mailed  to  you  as  soon  as they are
  125.        complete)  for  an  additional  $25.00  AUS.  Site  licenses  are
  126.        available at a reduced rate (contact the author).
  127.  
  128.        The user  supported software concept (also  known as "shareware")
  129.        is an attempt  to provide quality software at low cost.  Both the
  130.        user and author benefit from this plan.  The user will benefit by
  131.        being able to "test  drive" software thoroughly before purchasing
  132.        it.  The author  benefits by  being able  to enter the commercial
  133.        software  market  while  avoiding  the  high  cost  of commercial
  134.        distribution.
  135.  
  136.        This concept  helps many independent authors  and small companies
  137.        that would otherwise be discouraged from developing and promoting
  138.        their ideas.  It can only work with your support. If you obtain a
  139.        user supported program  from a friend and you  are still using it
  140.        after a few  weeks, then it is obviously  worth something to you,
  141.        and a contribution should be sent.
  142.  
  143.        For   further   information   and   registration,   please   send
  144.        correspondence to:
  145.  
  146.                Peter Ogden
  147.                ESB Consultancy
  148.                P.O. Box 2259,
  149.                Boulder,
  150.                Western Australia      6432
  151.  
  152.            or  Fax: +61 90 21 8364
  153.  
  154.        or,   for   information,   bug   reports,   or  suggestions  (not
  155.        registration) Netmail at 3:690/643.5 (FidoNet).
  156.  
  157.  
  158.  
  159.  
  160.        REBOOT v5.00 User Manual                                Page  -4-
  161.  
  162.  
  163.                       FILES INCLUDED IN THE REBOOT SUITE
  164.  
  165.        ACTIVE.EXE        Program  that  reports   the  active  (current)
  166.                          configuration.
  167.        BTIME.EXE         Program that adds or updates the Date/Time line
  168.                          in  REBOOT.CFG.  In  combination  with CHKBOOT,
  169.                          allows    conditional    processing    in   the
  170.                          AUTOEXEC.BAT (see also CHKBOOT.EXE).
  171.        CHKBOOT.EXE       Program  that  reads  the  Date/Time  line from
  172.                          REBOOT.CFG,  compares it  to the  current Date,
  173.                          and returns  a DOS error  level depending on  a
  174.                          supplied condition.
  175.        EXAMPLE1.CFG      An example config file (simple).
  176.        EXAMPLE2.CFG      An example config file (network).
  177.        EXAMPLE3.CFG      An example config file (complex).
  178.        REBOOT.DOC        This document.
  179.        REBOOT.EXE        The main REBOOT program.
  180.        REGISTER.FRM      Registration form.
  181.  
  182.  
  183.                                  COMPATIBILITY
  184.  
  185.        REBOOT should run  on any IBM PC, PC/XT, AT,  386 or 486 or close
  186.        compatible with  at least 128K  RAM (512K for  editing function),
  187.        single floppy disk drive, monochrome or colour display, MS/PC-DOS
  188.        version 3.0 or later, with or without a mouse.  Screen writes are
  189.        direct to video RAM (or if Desqview present, via a shadow buffer)
  190.        for reasonable  speed of display.  Users of EGA/VGA displays have
  191.        the option of high intensity backgrounds.
  192.  
  193.  
  194.                                   SETTING UP
  195.  
  196.        First, a  file containing all your  different configurations must
  197.        be  created (or  one of  the included  examples modified to suit)
  198.        using a standard ASCII text  editor, either from within REBOOT or
  199.        manually.  The general form of this file is:
  200.  
  201.  
  202.  
  203.  
  204.        REBOOT v5.00 User Manual                                Page  -5-
  205.  
  206.  
  207.        #Name = Config 1
  208.        {                                         }
  209.        {  Lines to be written to the CONFIG.SYS  }
  210.        {                                         }
  211.        ---
  212.        {                                         }
  213.        { Lines to be written to the AUTOEXEC.BAT }
  214.        {                                         }
  215.        #Name = Config 2
  216.        {                                         }
  217.        {                etc...                   }
  218.        {                                         }
  219.  
  220.        The REBOOT.CFG  starts with the name  given to this configuration
  221.        (which MUST  be unique).  It is followed by  the CONFIG.SYS lines
  222.        (as you  would normally have them in DOS's CONFIG.SYS),  followed
  223.        by  a  divider  line  (consisting  of,  at  least, 3 dashes '-'),
  224.        followed by the AUTOEXEC.BAT lines (also exactly as you have them
  225.        in DOS's AUTOEXEC.BAT).
  226.  
  227.        REBOOT.CFG should  be in a directory  that is in the  PATH or you
  228.        will  always  have  to  change  to  that directory before calling
  229.        REBOOT.
  230.  
  231.        Where  possible,  REBOOT  allows  comments  to be included in the
  232.        REBOOT.CFG.  To include  a full  line comment,  the character  in
  233.        column  one of  the line  must  be  a semicolon  (;) (see  sample
  234.        REBOOT.CFG's).  Any comment entered on a #Name command line after
  235.        column  28  is  ignored ('#Name =  '  + 20  character name).  Any
  236.        comments entered  after the divider  (on the same  line) are also
  237.        ignored.  Blank lines  may also  be included  in REBOOT.CFG  (not
  238.        written to the AUTOEXEC.BAT or CONFIG.SYS).
  239.  
  240.        All  commands for  REBOOT begin   with a  '#' symbol  (except the
  241.        active configuration as noted below), must begin in column 1, are
  242.        followed by space, an '=' symbol and another space.
  243.  
  244.              e.g., #Name = QEMM 5.11
  245.  
  246.        The command  may be in any  mixture of upper or  lower case (i.e.
  247.        #NAME = , #Name = , #name = , are all equivalent).
  248.  
  249.        The  current, active  configuration is  marked by  the use  of an
  250.        asterisk  (*)  instead  of  the  hash  symbol  (#)  as  the first
  251.        character of  a REBOOT special command.  All the commands related
  252.        to the active configuration must  begin with an asterisk (*) (see
  253.        example REBOOT.CFG's).
  254.  
  255.  
  256.  
  257.  
  258.        REBOOT v5.00 User Manual                                Page  -6-
  259.  
  260.  
  261.        REBOOT currently has eight special commands:
  262.  
  263.        #Name   This is the  only command that must be  in the REBOOT.CFG
  264.                file. This indicates the beginning of a configuration and
  265.                the  name to  use in  the pop  up pick list.  The maximum
  266.                length of the name is 20 characters (any characters after
  267.                this are ignored).  Any characters may be used  in a name
  268.                except the  slash (/) character (which  could be confused
  269.                with a command line option).
  270.  
  271.        #Descr  (Optional).  Allows a single line description to be given
  272.                for each  configuration (maximum of  80 characters). This
  273.                line  is displayed  at the  bottom of  the screen  as you
  274.                scroll through the pick list. The first 40 characters are
  275.                written to the 4DOS DESCRIPT.ION file if it exists.
  276.  
  277.        #Flush  (Optional).  This  is the command line you would  type to
  278.                flush the  delayed write (also called  staged write) disk
  279.                cache. If more than a  single line command is required to
  280.                flush the  cache, a batch file  may be named.  If you use
  281.                4DOS, this line can be a compound command (maximum of 255
  282.                characters).
  283.  
  284.                This line actually causes REBOOT  to EXEC another copy of
  285.                the command  processor, so in fact,  you could get REBOOT
  286.                to perform almost any function before booting.
  287.  
  288.        ***************************** NOTE ******************************
  289.  
  290.        If  you  use  a  delayed  write  disk  cache,  you  MUST  include
  291.        the #Flush line  in every configuration that loads  the cache, as
  292.        without  it, the  configuration may  not be  written to  the disk
  293.        completely before the PC is rebooted.  If this occurs, there is a
  294.        chance  that the  file allocation  table (FAT)  could be damaged,
  295.        possibly rendering the data on the  disk unreadable.  See example
  296.        configuration files for examples of how to set up PC-CACHE v6 and
  297.        HYPERDISK.
  298.  
  299.        *****************************************************************
  300.  
  301.        #Hist   (Optional).  This command  line gives  the full  path and
  302.                filename  of  the  command  history  file  to  store  the
  303.                command  history  for  this  configuration.  This  allows
  304.                multiple  (separate)  command  histories  to  be kept for
  305.                unique configurations.  If no #Hist line  is included, no
  306.                attempt is  made to save the command history.  Currently,
  307.                only 4DOS command history is handled.
  308.  
  309.  
  310.  
  311.  
  312.        REBOOT v5.00 User Manual                                Page  -7-
  313.  
  314.  
  315.        #Date   (Optional,  added  by  BTIME)  This  line  is  ignored by
  316.                REBOOT.  The Date  and Time  are added  to REBOOT.CFG  by
  317.                BTIME, and tested by CHKBOOT. ACTIVE also reads this line
  318.                and will display the time and  date of the last boot if a
  319.                valid time and  date are found.  The time and date should
  320.                not be manually entered (format is important).
  321.  
  322.        #Defs,  (Optional,  added by Install option)  These lines contain
  323.        #Defs2  all  the  customisation  information  (colours,  defaults
  324.                etc.) that the user selects with the Install option. This
  325.                line should not be manually edited.
  326.  
  327.        #Reg    (Optional,  added by  Install/Register option)  This line
  328.                holds the registration  information for registered users.
  329.                This line should not be manually edited.
  330.  
  331.        REBOOT  creates   the  CONFIG.SYS  by   reading  from  the   line
  332.        immediately  after  the  chosen  #Name  command (ignoring comment
  333.        lines  and blank  lines) up  to (but  not including)  the divider
  334.        line.  The AUTOEXEC.BAT is likewise  created by reading  from the
  335.        line immediately after  the divider to the next  #Name command or
  336.        the end of file (always ignoring blank lines and comments).
  337.  
  338.        The #Descr, #Flush and #Hist lines can be placed anywhere between
  339.        one #Name line and the next.
  340.  
  341.        All  modifications  to  the  configurations  should  be  made  to
  342.        REBOOT.CFG  (not  directly  to  the  AUTOEXEC.BAT  or  CONFIG.SYS
  343.        files). The  wrong flush command  may be used  if you change  the
  344.        type of disk cache in the CONFIG.SYS or AUTOEXEC.BAT directly. If
  345.        you  must  modify  or  create  a  new  CONFIG.SYS or AUTOEXEC.BAT
  346.        directly, be sure  to update the copy in  REBOOT.CFG, AND be sure
  347.        that the  special command lines  start with asterisks  (*) rather
  348.        than hashes (#) where necessary.
  349.  
  350.        REBOOT can optionally be forced  to write it's temporary files in
  351.        a directory pointed  to by the environment  variable TEMP. If you
  352.        have a slow  disk drive, you may wish  to set TEMP to point  to a
  353.        RAM Drive to  speed up the processing of  the REBOOT.CFG file. If
  354.        you have  a fast drive  or use a  large disk cache,  you may find
  355.        that pointing TEMP to the same drive that REBOOT.CFG is stored on
  356.        (or not setting it at all) will be faster.
  357.  
  358.  
  359.                        INSTALLING USER OPTIONS IN REBOOT
  360.  
  361.        Once  the REBOOT.CFG  file is  set up,  you may  install the user
  362.        options for REBOOT.  This can be done by  running REBOOT and then
  363.        pressing:
  364.  
  365.  
  366.  
  367.  
  368.        REBOOT v5.00 User Manual                                Page  -8-
  369.  
  370.  
  371.  
  372.                 Alt-I (or clicking on Install on the help line)
  373.  
  374.        This will  then show you  a screen offering  several sections you
  375.        may change.  The options available  include: setting the  colours
  376.        used  in  the  pick  list,  description  line, help line, warning
  377.        messages,   and  information   messages,  entering   registration
  378.        information, set  the disk that  the CONFIG.SYS and  AUTOEXEC.BAT
  379.        are to  be written to,  toggle mouse cursor  flashing on or  off,
  380.        toggle use of special reset code for  the DEC PCSA LAN on or off,
  381.        whether to default to a cold boot rather than a warm boot, and to
  382.        set  the  filename  of  the  editor  to  use  when  modifying the
  383.        configuration  file.   This  information  gets   written  to  the
  384.        REBOOT.CFG file.
  385.  
  386.        The editor filename entry can be entered in one of three ways. If
  387.        the editor can  be found via the DOS PATH,  only the file name of
  388.        the program is required (e.g. EDLIN). If the editor to use is not
  389.        in the  path, then the full  path, filename and extension  may be
  390.        entered (e.g.  C:\SYS\EDLIN.COM). Thirdly, you  may enter a  4DOS
  391.        alias. This  method requires the  command processor to  be loaded
  392.        (using up some  memory) and masks any errors  that have occurred.
  393.        Wherever possible  the most reliable  way of enabling  the editor
  394.        option is to  give the full path.  Most editors should be able to
  395.        load in the memory available,  an error message will be displayed
  396.        if there is insufficient memory to load.
  397.  
  398.        Colour  selections  selected  for  REBOOT  will  also be used for
  399.        ACTIVE.
  400.  
  401.        Pressing Escape  (or the right  mouse button) at  any time before
  402.        pressing Enter (or  the left mouse button) to  accept the setting
  403.        will  abort the configuration  without  making any  changes.  The
  404.        mouse is  fully functional throughout  the configuration program,
  405.        with the  left button being  the 'accept' key  (equivalent to the
  406.        'ENTER' key on the keyboard) and the right button the 'abort' key
  407.        (equivalent to the 'ESCAPE' key).
  408.  
  409.  
  410.                                 RUNNING REBOOT
  411.  
  412.        REBOOT can be run in two  ways:-
  413.  
  414.                REBOOT
  415.  
  416.        or      REBOOT Name
  417.  
  418.        If REBOOT  is typed without specifying  a name, a pick  list will
  419.        appear on screen of the configuration defined in REBOOT.CFG. If a
  420.  
  421.  
  422.  
  423.  
  424.        REBOOT v5.00 User Manual                                Page  -9-
  425.  
  426.  
  427.        name  is given,  the corresponding  configuration is  immediately
  428.        written and the computer rebooted.
  429.  
  430.        The   pick  list   allows  the   user  to   scroll  through   the
  431.        configuration  names  using  the  arrow  keys  (if  more  than 15
  432.        configurations exist, there is a  15 line window, and an elevator
  433.        bar will  appear).  If a  mouse driver is loaded, a configuration
  434.        can  be  chosen  by  pointing  to  the required configuration and
  435.        clicking the  left button once  to select, and  again to execute.
  436.        Alternately,   pressing  the   first  letter   of  the   required
  437.        configuration will move the cursor  bar to the next configuration
  438.        that  begins  with  this  letter.  When  the  highlight is on the
  439.        required configuration, pressing Enter  will start the write/boot
  440.        sequence. Pressing Escape, or the right mouse button, or the left
  441.        mouse button  while on the  Close Button (top  left of pick  list
  442.        border) any time before pressing Enter, or the left mouse button,
  443.        will  abort  without  writing  anything  and  without booting the
  444.        computer.
  445.  
  446.        While in the  pick list, four hot keys are  available to edit the
  447.        configurations (listed on the last line of the  screen).  Two hot
  448.        keys add new configurations to the end  of the list: Alt A (Add a
  449.        new configuration) and Alt C  (Copy the highlighted configuration
  450.        and modify).  Alt E allows you to Edit an existing configuration,
  451.        and Alt D allows deletion of an existing configuration.
  452.  
  453.        The REBOOT command  can also be followed by  any of the following
  454.        eight switches:
  455.  
  456.           /H and /?  (Help) both give a short  description of REBOOT and
  457.           the switches available.
  458.  
  459.           /N (No  boot) informs REBOOT to  write the configuration files
  460.           without  booting, allowing  you  to  boot with  this different
  461.           configuration at a later time. This option should be used with
  462.           caution, subsequent use of REBOOT will use this configurations
  463.           cache flushing  command and history updates,  which may not be
  464.           consistant with the active items.  See also /D.
  465.  
  466.           /C (Cold Boot) forces a  cold boot regardless of the installed
  467.           setting.
  468.  
  469.           /W (Warm Boot) forces a  warm boot regardless of the installed
  470.           setting.
  471.  
  472.           /R  (Return  to  Directory)  will  return  you to your current
  473.           directory after the configuration change. This is performed by
  474.           temporarily  appending three  lines: Drive  Name, CD Directory
  475.           Name, REBOOT /A XXXX (where  XXXX is the chosen configuration)
  476.  
  477.  
  478.  
  479.  
  480.        REBOOT v5.00 User Manual                                Page -10-
  481.  
  482.  
  483.           which  changes  to  the  appropriate  drive  and directory and
  484.           finally updates AUTOEXEC.BAT to remove these lines.
  485.  
  486.           /A (Autoexec only)  is a special command that  only writes the
  487.           AUTOEXEC.BAT file. The main use for this switch is by /R.
  488.  
  489.           /D (Down)  causes REBOOT to write  the selected configuration,
  490.           updating AUTOEXEC.BAT  and CONFIG.SYS (if  necessary), updates
  491.           the  History  file,  and  flushes  the  cache in readiness for
  492.           shutting off the computer (putting it down).
  493.  
  494.        Note: the cache is not flushed if the /N or /A switches are used.
  495.  
  496.  
  497.                               SEQUENCE OF EVENTS
  498.  
  499.        REBOOT  will perform  the following  sequence of  events once the
  500.        configuration has been selected and  the Enter key is pressed (or
  501.        if the configuration is given on the command line):
  502.  
  503.        REBOOT.CFG is scanned for the chosen configuration.
  504.        If  /A (Autoexec  Only) is  NOT  given  on the  command line  the
  505.        CONFIG.SYS  is written.
  506.        The AUTOEXEC.BAT is  written.
  507.        If /R is given on the command  line then three lines are added to
  508.        the  AUTOEXEC.BAT (Drive,  CD Current  Directory, REBOOT  /A XXXX
  509.        where  XXXX  is  the  chosen  configuration).
  510.        Active  markers are  updated in  REBOOT.CFG (*'s  replace #'s for
  511.        active config).
  512.        If /N (no  boot) is NOT given on the  command line, the following
  513.        are performed:
  514.           If  a #Hist  line is   found in  this configuration,  the 4DOS
  515.           history is  saved to the  file name listed  and duplicates are
  516.           removed.
  517.           If  a #Flush  line is  found in  this configuration,  the disk
  518.           cache is flushed using this command.
  519.           If /D (Down)  is NOT given on the  command line, the following
  520.           are performed:
  521.              If   DEC   PCSA   LAN   resetting   required   (enabled  in
  522.              installation), the LAN card is reset.
  523.              If  /W  is  given  on  the  command  line,  a  Warm boot is
  524.              performed, if /C is given on  the command line, a Cold boot
  525.              is performed, otherwise the PC  is booted using the default
  526.              booting method selected with the installation option.
  527.  
  528.  
  529.                               COMPANION PROGRAMS
  530.  
  531.        Three companion programs should be included in this package:
  532.  
  533.  
  534.  
  535.  
  536.        REBOOT v5.00 User Manual                                Page -11-
  537.  
  538.  
  539.        ACTIVE:
  540.  
  541.             This is a program that reports the active configuration, and
  542.             various system information. It shows the operating system in
  543.             use, and the configuration name as listed in REBOOT.CFG. Any
  544.             Any  description  line  included   in  REBOOT.CFG  for  this
  545.             configuration is displayed on the bottom line of the screen.
  546.             An errorlevel  is returned dependent  on the key  pressed to
  547.             exit the program.  The errorlevel returned is ascii value of
  548.             the uppercase of the key (Y = y = errorlevel 89).
  549.  
  550.        BTIME:
  551.  
  552.             This small program reads the  current time and date from DOS
  553.             and writes it  to the first line of REBOOT.CFG.  This should
  554.             only be run  from the AUTOEXEC.BAT file, as  its function is
  555.             to indicate  the approximate time and  date the computer was
  556.             last booted.  CHKBOOT should be called  before BTIME updates
  557.             the time  in REBOOT.CFG.  If the computer requires a program
  558.             to be run to set the DOS time, then BTIME should be run some
  559.             time after  the timer program.  Type "BTIME /?" (without the
  560.             quotes) for a short explanation of how to use BTIME.
  561.  
  562.        CHKBOOT:
  563.  
  564.             This  program compares  the  current  time and  date against
  565.             the time  and date set by  BTIME in the REBOOT.CFG  file and
  566.             returns  an errorlevel  dependent on  conditions supplied on
  567.             the command line.  CHKBOOT has five  switches to control the
  568.             comparison of time and date:
  569.  
  570.                /F        (default) returns an errorlevel  of 1 (true) if
  571.                          this  is  the  First  boot  of  the  day, or an
  572.                          errorlevel of 0 (false) if not. This switch may
  573.                          be omitted from the command line.
  574.  
  575.                /A:HH:MM  returns  true  if  the  current  time  is After
  576.                          (greater than  or equal to)  the time given  as
  577.                          HH:MM.
  578.  
  579.                /B:HH:MM  returns  true  if  the  current  time is Before
  580.                          (less than) the time given as HH:MM.
  581.  
  582.                /D:DDD    returns true  if the current  day is DDD  (i.e.
  583.                          Mon, Tue,  etc.), AND it  is the first  boot of
  584.                          the  day. Can  be used  for once  a week bootup
  585.                          procedures.
  586.  
  587.                /M:NN     returns true if the current day of the month is
  588.  
  589.  
  590.  
  591.  
  592.        REBOOT v5.00 User Manual                                Page -12-
  593.  
  594.  
  595.                          NN (i.e. 1  for the first of the  month, 30 for
  596.                          the  30th of  the month,  etc.), AND  it is the
  597.                          first boot of  the day.  Can be used for once a
  598.                          month bootup procedures.
  599.  
  600.             If  an  error  occurs,  then  an  errorlevel  of 255 will be
  601.             returned. See the example  REBOOT.CFG's for typical usage of
  602.             BTIME and CHKBOOT.  Type "CHKBOOT  /?" (without the  quotes)
  603.             for a short explanation of how to use CHKBOOT.
  604.  
  605.  
  606.                                TROUBLE-SHOOTING
  607.  
  608.        REBOOT.CFG corruption:
  609.  
  610.        If you  are having trouble with  REBOOT corrupting its REBOOT.CFG
  611.        file,  there is  a good  chance you  are using  a disk cache that
  612.        delays writing to the disk. If so, there MUST be a #FLUSH command
  613.        in the REBOOT.CFG  file that will flush or disable the cache.  If
  614.        you are using  a delayed write disk cache, and  you have a #FLUSH
  615.        line, check that the cache program  is either in the PATH, or the
  616.        full filename  and path of the  cache flush command is  given (an
  617.        error should  be displayed if the  file cannot be found,  but may
  618.        flash  by so  quickly that  it is  not noticed).  See the example
  619.        #FLUSH commands in the example configurations.
  620.  
  621.        Erratic Mouse Flashing:
  622.  
  623.        Some mouse drivers  are unable to react fast  enough to flash the
  624.        mouse cursor  on and off while  still being active.  The Logitech
  625.        mouse driver version 5.01 is known  to cause some trouble in this
  626.        regard.  Turn the mouse flashing option off if problems do occur,
  627.        then exit from REBOOT and restart.
  628.  
  629.        Insufficent memory for editor:
  630.  
  631.        REBOOT remains resident in memory  while the editor is called. If
  632.        this  error occurs,  remove as  many memory  resident programs as
  633.        possible  to  free  up  sufficient  memory  for  REBOOT  and your
  634.        favourite editor.
  635.  
  636.        Error - unable to load editor:
  637.  
  638.        This error  message is not  the same as  the last.  If this error
  639.        occurs, it is probably because  the editor has not been correctly
  640.        specified in the installation.  Where possible, the full path and
  641.        file name should be supplied for REBOOT to find the editor.
  642.  
  643.  
  644.  
  645.  
  646.        REBOOT v5.00 User Manual                                Page -13-
  647.  
  648.  
  649.        Error - unable to create temporary file:
  650.  
  651.        If this error message occurs, it may mean one of two things.  The
  652.        most likely is that there  is a TEMP environment variable defined
  653.        that is not pointing to a valid directory.  The other possibility
  654.        is  that there  was a  write error  (hardware) when attempting to
  655.        create the  file.  The solution  to the most  common reason is to
  656.        either   SET   the   TEMP   environment   variable   to  a  valid
  657.        drive/directory, or remove the TEMP environment variable entirely
  658.        (SET TEMP=).
  659.  
  660.        Error - unable to create REBOOT.TMP:
  661.  
  662.        REBOOT attempts  to create a file  called REBOOT.TMP (a temporary
  663.        file that is merged back into REBOOT.CFG when you finish editing)
  664.        whenever you  call the editor  from within REBOOT.  If this error
  665.        occurs, check to see that there  is not another file of this name
  666.        in the directory pointed to  by the TEMP environment variable, or
  667.        if  no  TEMP  environment  variable  exists,  the  directory that
  668.        REBOOT.CFG resides in.
  669.  
  670.        Error - unable to open REBOOT.CFG:
  671.  
  672.        This error message  may occur if the REBOOT.CFG file  is not in a
  673.        directory specified by the DOS PATH.  Another possibility is that
  674.        the REBOOT.CFG  file has been  marked Read Only.  REBOOT requires
  675.        read/write  access  to  the  REBOOT.CFG,  remove  the  Read  Only
  676.        attribute.
  677.  
  678.        Error - null #Name encountered:
  679.  
  680.        This may occur if you manually edit the REBOOT.CFG file and enter
  681.        a #Name = line  without actually specifying a name.  The #Name is
  682.        required for each configuration, and each must be unique. At this
  683.        point in time, REBOOT will not detect duplicate names and display
  684.        both in the  pick list, though only the  first configuration will
  685.        be written if either of the configurations is chosen.
  686.  
  687.        REBOOT may report other error  messages, though those not covered
  688.        here  should  not  occur  unless  some  sort  of hardware related
  689.        problem occurs (bad sectors on the hard disk, etc.).  If an error
  690.        occurs that is not covered  here that is not immediately obvious,
  691.        and you  do not believe  should have occurred,  please send me  a
  692.        copy of  your REBOOT.CFG file,  along with a  note explaining the
  693.        conditions  under  which  the  error  can  be  duplicated, to the
  694.        address noted above or via Fidonet Netmail to 3:690/643.5.
  695.  
  696.  
  697.  
  698.  
  699.        REBOOT v5.00 User Manual                                Page -14-
  700.  
  701.  
  702.                                 PROGRAM HISTORY
  703.  
  704.        v1.61 : First  public  release  (Public  Domain).  Keyboard  only
  705.                operation.
  706.  
  707.        v2.00 : Full mouse and  keyboard  user interface (scrollable menu
  708.                list  with   "elevator  bar").  Windowed,   mouse  driven
  709.                configuration.  Larger 4DOS  history file  can be handled
  710.                (4096 bytes maximum with no more than 2048 lines).  Fixed
  711.                Bug where History was written even when disabled.
  712.  
  713.        v2.11 : Changed  handling  of  Disk  Cache  Flushing.  The  flush
  714.                command is  no longer stored within  the EXE file (allows
  715.                program  to be  compressed  with  LZEXE or  similar after
  716.                configuration).  Companion program ACTIVE.EXE included to
  717.                give easy identification of current configuration.
  718.  
  719.        v2.12 : Bug   fix  for   cache  flush   being  indeterminate  for
  720.                configurations without a #Flush line.
  721.  
  722.        v2.13 : Bug  fix for  #Names  longer  than 20  characters causing
  723.                active  markers to  be removed.  Fix for  ACTIVE crashing
  724.                when no description.
  725.  
  726.        v2.14 : Bug fix for command line  entry of configuration name not
  727.                flushing cache.
  728.  
  729.        v2.16 : Network  compatibility  increased.  Bug  fix  for  ACTIVE
  730.                returning incorrect 4DOS version.
  731.  
  732.        v3.00 : Major rewrite  of all programs.  Optimised for speed  and
  733.                size, added DOWN.EXE (replaces DOWN.BTM). Changed version
  734.                numbers  of  companion  programs  to  same  as REBOOT for
  735.                consistency.
  736.  
  737.        v3.01 : Multiple  History files  allowed -  #Hist command  added.
  738.                Distributed as Shareware from this version on.  Fixed Bug
  739.                concerning Logitech Mice.
  740.  
  741.        v3.02 : Cold boot/Warm boot override command line switches added.
  742.                NOTE: COMMAND LINE SWITCHES CHANGED; /C now causes a Cold
  743.                boot  override,  /I  (Install)  replaces  the previous /C
  744.                (Configure).  Four new  utility programs  added: BTIME  &
  745.                CHKBOOT  (conditional  booting  utilities),  TIMEBOOT and
  746.                TIMEDASK.  Bug  fix  for  MS-DOS  4.xx  large partitions.
  747.                Rewritten DOWN  to include multiple  history files (which
  748.                was missed in the 3.01 release). Option included to reset
  749.                DEC  PCSA  LAN  cards  (not  tested).  ACTIVE modified to
  750.                include boot  time and current time.  COMPACT, REBOOT and
  751.  
  752.  
  753.  
  754.  
  755.        REBOOT v5.00 User Manual                                Page -15-
  756.  
  757.  
  758.                DOWN  modified to  ignore case  when removing  duplicates
  759.                from history files.
  760.  
  761.        v3.03 : Bug  fix  for  monochrome  screens  losing  entries  from
  762.                display.  Was supposed to have been fixed in last version
  763.                but was unfortunately left out.
  764.  
  765.        v4.00 : Major rewrite  of file input  and output routines  in all
  766.                programs  (Speed  has   improved  markedly).  Editing  of
  767.                configurations  now  available  (using  your own editor).
  768.                COMPACT  handles  files  twice  as  large  as previously.
  769.                Compacting  algorithm reworked,  now more  than twice  as
  770.                fast.  Error handling improved,  fixed lock up with  some
  771.                user errors.
  772.  
  773.        v4.01 : REGISTRATION CHANGED: once only  payment for this version
  774.                and  ALL  subsequent  versions  (users already registered
  775.                need pay no extra money).  BRAND program no longer needed
  776.                to register program  (registration function now available
  777.                from install).  All defaults and registration information
  778.                is  now  stored  in  config  file,  allowing  EXE's to be
  779.                compressed with LZEXE/PKLITE  etc. (also means subsequent
  780.                versions will be already setup with your colour selection
  781.                and registration). Bug fix for configuration files larger
  782.                than 8K  having problems updating # and *.  Alias allowed
  783.                for calling  editor.  Mouse selection of options on  help
  784.                line now available.  Option to turn flashing mouse cursor
  785.                on  or off  (now defaults  to off,  as some mouse drivers
  786.                have  problems  with  flashing  mouse  cursor).  TIMEBOOT
  787.                modified to allow for use during midnight rollover.
  788.  
  789.        v4.02 : /R and  /A switches added, /I switch removed.  /R Returns
  790.                you to your current directory  after rebooting with a new
  791.                configuration. /A writes the AUTOEXEC.BAT file only (used
  792.                by /R switch). The first 40 characters of the #Descr line
  793.                are   now   written   to   a   4DOS   DESCRIPT.ION  file.
  794.                Optimisations made  to all utilities.  Due to the size of
  795.                the  ZIP  file  being   rather  large  for  international
  796.                distribution,   some   of    the   utilities   previously
  797.                distributed with this  package now distributed separately
  798.                (COMPACT,  TIMEBOOT,  TIMEDASK,  SQZ.BTM)  in  a 4DOS/DOS
  799.                BATCH Utility  Archive.  Look for 4DDBU402.XXX (where XXX
  800.                is  ZIP,  LZH  etc.).  These  are  the  files that do not
  801.                require  REBOOT.CFG to  be present  to work.  Bug fix for
  802.                registration  option  creating  multiple  copies  of #Reg
  803.                line.  /R switch added to DOWN program. As for REBOOT, /R
  804.                returns you to your current directory at next boot-up.
  805.  
  806.  
  807.  
  808.  
  809.        REBOOT v5.00 User Manual                                Page -16-
  810.  
  811.  
  812.        v5.00 : Complete  replacement  of  all  low  level  routines with
  813.                highly  optimised  assembler   routines.  User  interface
  814.                reworked,    modernised.   Mouse    routines   completely
  815.                rewritten,  allowing auto  repeat on  holding down  mouse
  816.                button.  Desqview compatibility  added.  /D (Down) switch
  817.                added, allows choice of  configuration for next power up.
  818.                DOWN program removed (replaced by DOWN.BAT).  This switch
  819.                was added  to fix problems people  were having with using
  820.                REBOOT /n to set the  configuration to use at next switch
  821.                on, then  using DOWN before  switch off.  This caused the
  822.                wrong history files to be updated, and possibly the wrong
  823.                cache flush  command to be used.  The asterisk (*) symbol
  824.                is   now   available   as   a   synonym   to  the  active
  825.                configuration.  An example of the use  of this feature is
  826.                as a replacement for the DOWN program:
  827.  
  828.                         REBOOT * /D
  829.  
  830.                This will cause REBOOT to  flush the cache and update the
  831.                history   file  but   not  write   the  AUTOEXEC.BAT   or
  832.                CONFIG.SYS.  Bug  fix  for  first  letter  searching  not
  833.                working.  Bug  fix  for  very  occassional '#' characters
  834.                ending up in the wrong place for config files larger than
  835.                8K.  Bug fix for DESCRIPT.ION file  being written even if
  836.                one did not exist before.  ALL temporary files written to
  837.                directory pointed  to by TEMP environment  variable if it
  838.                exists.  New configurations are now  checked for validity
  839.                before creation. Ability to create REBOOT.CFG (if it does
  840.                not exist) from within REBOOT.  ACTIVE improved, with DOS
  841.                5.0 loaded, will  inform whether DOS is loaded  in HMA or
  842.                ROM.
  843.  
  844.  
  845.                                  ABOUT REBOOT
  846.  
  847.        For those that are interested, the REBOOT suite was written using
  848.        Turbo Pascal  6.0 (no matter what  anyone else says, this  is the
  849.        best version yet!) and Turbo  Assembler 2.0, with assistance from
  850.        Turbo  Debugger  and  Turbo  Profiler.  The  unit  libraries were
  851.        written by Glenn Crouch and Peter Ogden. The author would like to
  852.        thank Glenn  Crouch and Jason Cowie  (beta tester extraordinaire)
  853.        for their  patience and thoroughness  in beta testing  REBOOT and
  854.        its associated programs.
  855.  
  856.  
  857.  
  858.  
  859.        REBOOT v5.00 User Manual                                Page -17-
  860.  
  861.  
  862.                                ACKNOWLEDGEMENTS
  863.  
  864.        4DOS is copyright Rex Conn & J.P. Software.
  865.        MS-DOS is copyright Microsoft.
  866.        PC-DOS is copyright IBM.
  867.        PC-Cache is copyright Central Point Software Inc.
  868.        Hyperdisk is copyright Roger Cross.
  869.        QEMM and Desqview are copyright Quarterdeck Office Systems.
  870.        DEC and DEC PCSA are trademarks of Digital Equipment Corporation.
  871.        LZEXE is copyright Fabrice Bellard.
  872.        PKLite is copyright PKWare.
  873.        Turbo Pascal, Turbo Assembler,  Turbo Debugger and Turbo Profiler
  874.        are copyright Borland International.
  875.  
  876.                                    ---***---
  877.  
  878.